home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,101 to 4,200 / aol-file-protocol-4400-4101-to-4200.zip / AOLDLs / ADV - Articles & Misc / Manual for ProDev DDT8_DDT16 / DDT.MANUAL.bxy / DDT.Manual / CHAPTER.1 (.txt) < prev    next >
AppleWorks Document  |  1993-08-05  |  13KB  |  253 lines
  1. O=====<====<====<====<====<====<====<====<====<====<====<====<====<====<====<===
  2. O=====<====<====<====<====<====<====<====<====<====<====<====<====<====<====<===
  3. life.  (St. John 3:16) him should not perish, but have
  4. ProDev
  5.   DDT8 v1.6 & DDT16 v1.7
  6. (Development & Debugging Tool)
  7. User Manual
  8. ProDev, Inc.
  9. Chuck Kelly
  10. Christ is the Answer!
  11. CUSTOMER SATISFACTION
  12. H                         Should you discover any defects in either this 0
  13. .manual or the ProDev DDT card, ProDev, at our ,
  14. *option, will replace the documentation or 3
  15. 1provide revisions and will replace or repair the ,
  16. *ProDev DDT at no charge to you during the 1
  17. 180-day period after you purchased the product.
  18. LIMITATION ON WARRANTIES AND LIABILITY
  19. H                         Even though ProDev has tested this product for 1
  20. /proper operation, neither ProDev, its dealers, 1
  21. /representatives or agents make any warranty or /
  22. -representation, either expressed or implied, ,
  23. *with respect to this documentation or the 0
  24. .accompanying hardware and/or firmware. ProDev 0
  25. .disclaims any and all liabilities for direct, 1
  26. /indirect, incidental, or consequential damages 1
  27. /as a result of using this manual or ANY ProDev 1
  28. /hardware and/or firmware. ProDev shall have no 2
  29. 0liability for the loss of any programs or data, 2
  30. 0including the cost of recovering these programs 2
  31. 0or data or for any other losses which may occur 3
  32. 1as a result of using this product. This warranty ,
  33. *is void in the cases of misuse or damages 2
  34. 0resulting from sources other than the operation 0
  35. .of this product. Some states do not allow the 0
  36. .limitation of implied warranties or liability *
  37. (for consequential damages, so the above #
  38. limitations may not apply to you.
  39. COPYRIGHT
  40. F                         This manual, the firmware (ProDev DDT object 2
  41. 0code in ROM and programmable integrated circuit 2
  42. 0chips) and the layout of the electronic circuit 3
  43. 1board are copyrighted by ProDev, with all rights 0
  44. .reserved. Owner's of the DDT are hereby given 3
  45. 1permission to copy and distribute the ProDev DDT 1
  46. /manual, source code and object code as long as #
  47. our copyright notice is included.
  48. G                         Copyright 1985, 1986, 1987, 1988, 1989, 1990, 
  49. 1993 By:/
  50.                          ProDev, Incorporated&
  51.                          LaSalle, MI
  52. CONTENTS
  53. Chapter 1     INTRODUCTION
  54.                What is the ProDev DDT,
  55.                Symbols Used in This Manual
  56.                Installation
  57. Chapter 2     GETTING STARTED
  58.                The Main Display Screen
  59.                Tracing Code%
  60.                Setting Break Points
  61. Chapter 3     SETUP COMMANDS
  62.                M or ?
  63. Menu of Commands1
  64.                MO
  65. Mode of Operation7
  66.                esc            Return to Command Level5
  67.                SS A
  68. Setting Soft Switches4
  69.                SD T
  70. Setting Display Type/
  71.                ON
  72. Main Display On0
  73.                OFf
  74. Main Display Off+
  75.                KEy
  76. Command Key
  77. Chapter 4     BREAK POINTS
  78.                SB [T A.N]     Setting Break Points@
  79.                SB C A,R=n     Setting Conditional Break Points5
  80.                RB A           Removing Break Points6
  81.                HB [A]         Setting Hardware Break5
  82.                RH             Remove Hardware Break1
  83.                RA             Remove All Breaks%
  84.                The Button Interrupt
  85. Chapter 5     DISPLAYING AND MODIFYING
  86.                Li [A]         List Disassembled Code1
  87.                DR             Display Registers8
  88.                R=n            Changing Register Values+
  89.                MD [A]         Memory Dump1
  90.                MW             Set Memory Window-
  91.                MM [A]         Memory Modify.
  92.                MA [A]         Mini Assembler5
  93.                PW             Set Protection Window
  94. Chapter 6     TRACING AND RUNNING
  95.                RT             Real Time Subroutines<
  96.                down           Skip the Current Instruction)
  97.                ST [N]         Step Code*
  98.                TR [N]         Trace Code6
  99.                TS A           Trace Using Subroutine,
  100.                EX [N]         Execute code3
  101.                ER             Execute to Next RTS.
  102.                ET A,A         Execution Time6
  103.                GO [A]         Run Code at Full Speed1
  104.                JS A           Do JSR to Address
  105. Chapter 7     EXIT
  106.                * & **         Go to System Monitor8
  107.                QUit           Leave ProDev DDT via RTS
  108. Chapter 8     OUTPUT
  109.                Remote Terminal Operation
  110.                Printer Output
  111. Chapter 9     CUSTOMIZING
  112.                Setting ProDev DDT Options From Software@
  113.                Subroutines for "Trace with Subroutine" Command
  114. Appendix A    IT DON'T WORK
  115.                Trouble shooting
  116. Appendix B    GENERAL COMMENTS
  117. Appendix E    ERROR NUMBERS
  118. CHAPTER 1
  119. INTRODUCTION
  120. INTRODUCTION
  121. GThe ProDev DDT8 is compatible with the Apple //e and enhanced //e. The L
  122. JDDT16 is compatible with the Apple IIGS. The 6502, 65C02 and 65802 (65816 K
  123. IIIGS) are supported. This manual is written with the assumption that the D
  124. Buser is familiar with the Apple II series of computers. A working K
  125. Iknowledge of assembly language programming for the 6502 or 65816 is also H
  126. Fassumed, but you do not need to be an experienced programmer to begin H
  127. Fusing the ProDev DDT. Indeed, using the ProDev DDT should help you in ;
  128. your efforts to understand assembly language programming.
  129. DThe ProDev DDT contains one of the most powerful debugging programs L
  130. Javailable for the Apple II computer. But the ProDev DDT is much more than L
  131. Jjust a tracing program. It is a combination of a very extensive debugging I
  132. Gprogram along with powerful hardware features, all working together to I
  133. Gcreate, what we feel, is the most powerful and unique programming tool &
  134. available for the Apple
  135. II computer.
  136. HBecause the ProDev DDT's program is entirely in ROM (Read Only Memory), D
  137. Bit's always there when you need it. You don't need to worry about K
  138. Iinterfering with the program you are working with because the ProDev DDT D
  139. Bis virtually transparent to the computer. In addition, there is a L
  140. Jhardware STOP ON ADDRESS which actually watches the addresses as they are I
  141. Gbeing sent out by the computer and stops the program when the location L
  142. Jyou have specified is accessed. Another hardware feature is the EXECUTION H
  143. FTIMER, which counts the number of machine cycles a section of program I
  144. Gtakes to execute. The TRACE function is executed with hardware and not K
  145. Isoftware like the others, so it allows you to actually see the affect of I
  146. Gillegal instructions on your program flow. The ProDev DDT's program is K
  147. written entirely in Assembly language for the fastest operation possible.
  148. FFrom the very beginning the ProDev DDT was designed to be used by the H
  149. Fdemanding professional who will appreciate the many powerful features ,
  150. incorporated into the design. For example:
  151.      Full support of the 6502, 65C02, 65802 (65816 IIGS)!J
  152. H     The ability to use external displays to do program debugging while 4
  153. viewing your program's output on the Apple screen!B
  154.      Tracing programs that actually reside in the text RAM area!L
  155. J     Access to the Non Maskable Interrupt for gaining control of programs 7
  156. that are in tight loops or lost in never, never land!
  157.      And many more features.
  158. SYMBOLS AND CONVENTIONS OF THIS MANUAL
  159. HAll commands to the ProDev DDT must end with pressing the "Return" key. F
  160. DThroughout the rest of this manual that fact will be assumed. A few G
  161. examples use the symbol "<cr>" to indicate pressing the "Return" key.
  162. JSome inputs require entering "control characters". Control characters are J
  163. Hrepresented by "<ctrl>-Letter". To enter a control character, hold down .
  164. the "Control" key and press the desired key.
  165. FCommand items in brackets "[A]" are optional but the operation of the J
  166. Hcommand may be different if they are omitted. The letter "A" is used to K
  167. Iindicate a memory Address. The letter "N" represents a Number other than 
  168. an address.
  169. EAll numbers displayed by the ProDev DDT are in Hexadecimal (base 16) I
  170. Gformat. In order to save screen space, dollar signs do not precede the     
  171. digits.
  172. GThe ProDev DDT assumes all inputs are in Hexadecimal format. Preceding I
  173. Gdollar signs are optional. To specify a Decimal entry you must precede +
  174. the number with an exclamation point "!".
  175. EXAMPLE:  Inputs of 10 or $10 both equal $10 (16 decimal).9
  176.           An input of !10 is equal to $0A (10 decimal).
  177. GThe command prompt for the ProDev DDT is ":". The prompt is changed to L
  178. J"!" when you enter the MINI-ASSEMBLER. When a command prompt is displayed 8
  179. it indicates the ProDev DDT is waiting for your input.
  180. DThe term "target" refers to the program that is being debugged. For K
  181. Iexample, "the target's text display" would refer to the output generated  
  182. by the program being debugged.
  183. FThe letter "n" is used to represent the slot number of the ProDev DDT H
  184. Fcard. If an example has an address of "Cn00" you would substitute the K
  185. Islot number of the ProDev DDT card for the letter "n". If the ProDev DDT I
  186. card is installed in slot number 4 you would use "C400" as the address.
  187. GThe symbols {DDT8} or {8} are used in this manual to indicate features J
  188. Hrelated only to the DDT8 for the Apple //e. The symbols {DDT16} or {16} (
  189. refer to the DDT16 for the Apple IIGS.
  190. INPUT ERRORS
  191. HIf you input a command incorrectly, the ProDev DDT will usually respond K
  192. Iwith a "beep" and a circumflex "^" to indicate the general area in which L
  193. Jthe command was in error, followed by an error number. See Appendix E for D
  194. Ba list of error numbers. In some cases a specific message will be K
  195. Idisplayed describing the error. Every effort was made to make the ProDev I
  196. GDDT as user friendly as possible without sacrificing too much valuable 
  197. program space.
  198. BANK NUMBERS
  199. FBank numbers may be entered for most commands. VERY IMPORTANT!! If no H
  200. Fbank number is specified, then the last bank number referenced by the I
  201. GProDev DDT will be used. Bank numbers must be followed by a slash "/". 
  202. (E.G.  00/2000).
  203. I{DDT8} - Bank 01 refers to the alternate 64K of RAM in 128K Apple //e's. G
  204. EIf you have an Applied Engineering Ramworks board or equivalent, you +
  205. may specify bank numbers greater than 01.
  206. I     NOTE! The Ramworks manual refers to the lowest bank on the Ramworks @
  207. >card as bank 0. We refer to the main system memory as bank 0. E
  208. CTherefore, the ProDev DDT displays the lowest bank on the Ramworks 
  209. card as bank 1.
  210.      ***** ALERT *****I
  211. G     Entering bank numbers greater than the actual amount of memory in 0
  212. your system may result in lost data in bank 0.
  213. INSTALLATION INSTRUCTIONS
  214. ***** 
  215. W A R N I N G
  216.  *****
  217. GAlways make sure the computer power is off when installing or removing I
  218. Gany peripheral card, including the ProDev DDT. This is very important, K
  219. Iand failure to do so will result in damage to the ProDev DDT card and to ,
  220. your computer and will void your warranty.
  221.  Installation steps:
  222. 1. Turn off the power to your computer and all equipment connected to it.
  223. ***** 
  224. W A R N I N G
  225.  *****
  226. IPlugging the ProDev DDT card into the AUX CONNECTOR of an Apple
  227. //e will >
  228. result in severe damage to the ProDev DDT and to your Apple.
  229. J2. Along the back edge of the Apple are several long connector slots. The G
  230. EProDev DDT card will work in any of these slots with two exceptions. H
  231. F(DDT8) Do not use the AUX connector which is positioned closer to the K
  232. Ikeyboard and next to the power supply. Do not use slot #3 if you have an H
  233. F80 column card installed in the AUX connector. (DDT16) Do not use the H
  234. Memory Expansion connector which is positioned closer to the keyboard.
  235. I3. The ProDev DDT card has a row of gold plated contacts along one edge. B
  236. Try not to touch these contacts. Be sure the power is still off.
  237. F4. Follow the instructions supplied with your computer for installing 
  238. peripheral cards.
  239. J5. The cable may be fed through any of the available openings in the back 
  240. of the computer.
  241. 6. Place the cover on your computer.
  242. H7. Turn your computer power back on and activate the ProDev DDT card by "
  243. entering the following commands:
  244. E(DDT16) The control panel setting must be set for "YOUR CARD" in the 
  245. DDT16 slot.
  246. ] CALL -151
  247.   <cr> "This puts you in the monitor program".I
  248. * Cn00G
  249.  <cr>                "n is the slot number of the ProDev DDT".
  250. GYou should be greeted with the ProDev DDT version number and copyright H
  251. Fnotice. If not, double check the installation procedures and read the 
  252. section on "IT DON'T WORK".
  253.